Graham Speller is a complete spelling environment. It checks your spelling as you type and will beep to tell you of your mistake. Speller can also check a selected portion of text, guess the correct spelling of a word or find a synonym for you. The dictionary contains over 75,000 words and the Thesaurus contains literally thousands of synonyms. You can easily add your own "custom" words to the dictionary. If you wish to expand the Thesaurus you may add your own words (if you follow the rules - more on that later). To explain how to use Graham Speller let's use it!!
Warning - Graham Speller will not work correctly with a Macintosh 128K or the Mac 512K. It will work with the Mac 512K enhanced, MacPlus, Mac SE and the Mac II.
Installing Graham Speller
The Graham Speller disk is not a start-up disk, so you must use a disk with a system file on it to start your Mac. After you have started up your Macintosh insert the Graham Speller master disk into a drive.
Double-click on the Graham Speller desk accessory icon.
This will start up the program named Font/DA Mover.
Your screen will look similar to the picture below.
Click on the Open button to choose a System file to copy Graham Speller into.
Your screen will look similar to the picture below.
Select Graham Speller by clicking on it and then click the >>Copy>> button to copy it into the System file. Click the Quit button to return to the Finder.
Practice Session
Of the files included with the Speller, you will always be using the dictionary. The Thesaurus and Macro files are there if you want to use them.
The files are:
Speller.Dictionary 75,000 words
Speller Thesaurus helps you find the appropriate synonym
Speller Macros expanded text for key words
There is also a smaller dictionary file included named "Speller.Dictionary(21K)".
This dictionary has only 21,000 words and is for use with the Mac 512K e. It may also be used anytime you need more memory for the application you are using.
After you install the Speller desk accessory in your system file you will also need to have the Dictionary, Thesaurus and Macro files together on the same disk within the same folder. The Dictionary will "auto-load" if it is in the root directory (window) of the disk. Simply copy the Dictionary, Thesaurus and Macro files into the window of the disk you want them on. Do not put them inside any folders if you want the "auto-load" feature to work correctly. If Speller does not find the Dictionary, an "Open" dialog box will allow you to locate it.
Now we really are ready to begin. First, start up your favorite word processing program. Once the word processor is ready to go, pick Graham Speller from the menu. It will take a few seconds for Speller to load the dictionary into memory and then you will see Speller's menu and window appear.
A portion of the window is shown below.
The window shows how many words are in the current dictionary and the name of the programmer who wrote Graham Speller. Press the space bar to clear the Typed and Found boxes. Now you will see how Graham Speller works.
The name of the Speller window shows the name of the current dictionary. (Using different dictionaries will be explained later.)
The alphabet at the top of the window is used as an index to the dictionary. Click on any letter. Let's try "B". You will see a "b" appear in the Found box, "azurite" in the Before box and "babbitt" in the After box. As you can tell, the Found box shows what Speller found when you clicked the "B". The Before and After boxes show the words which are before and after the Found word in the dictionary. You can see 3 words at a time in the Speller window that are from the dictionary. They appear in alphabetical order from left to right (Before, Found, After). Try clicking on other letters and see what happens.
Now click "B" again. Immediately to the right of the alphabet is a small scroll bar. Click (and hold down the button) on the arrow which points to the right and the words will scroll through the dictionary toward the end of the alphabet. Click (and hold down the button) on the left arrow and the dictionary will scroll toward the beginning of the alphabet. The entire dictionary can be seen using this method. If the scrolling is too slow for you, simply hold down (and keep holding) the option key before you click on one of the arrows in the scroll bar. Can you read that fast?
Now let's try typing. The Typed box shows the word you are currently typing. The word in the Found box will change as you type. (The words in the Before and After boxes change also.) Type one letter at a time to spell the following word: a n y t h i n g. As you type, Speller first found 'a', then 'an', then 'any', and then 'anything', even before you finished typing the word!! With each letter you type, Speller will keep up with you as if you had a friend quickly looking through a dictionary with each key stroke. The instant you make a mistake Speller will beep. Speller will not slow down your typing since it can check up to 90 words a second. Can you type that fast?
Now let's try typing into a word processing document. First click on your word processor's window to bring it in front of Speller. Next, resize the word processor window so that it allows you to see the Found box of Speller. Something like the example below.
Then, as you type, you will be able to see the words Speller finds. If you make a mistake, Speller will beep and you will be able to see what it found and where the mistake was made. Try typing a few paragraphs to get the feel of Speller.
Speller Menu
Now you are ready to try some of the really powerful features of Speller.
We will try all the items in Speller's menu one at a time and explain all the options along the way.
Clear or (option C)
The Clear command is near the bottom of Speller's menu, but it is important to understand the need for it's existence. Speller is designed to check your spelling as you type. When you do a lot of editing, Speller can be confused when you move the insertion point (the place where you are currently typing). Example: type test and then move the insertion point (the place where you are currently typing) to just before the first "t" of the word test. Next, type my. Speller will beep and show testmy in the Typed box. Therefore, the Clear command is provided to clear Speller's memory and allow you to start a new word. Normally, Speller will think you are on the next word when you press a key that is not a letter of the alphabet. The keyboard command option-C is easier to use when you need to Clear Speller.
Guess...
The Guess function is very smart and it's easy to use. Make sure that your word processor's window is in front of Speller's and type the following word: angy. Next, pick Guess from the Speller menu. You will see the following window appear:
The Guess window shows the word you typed at the top. The buttons below the typed word contain Speller's guesses. If you click in one of these buttons, the word you typed will be replaced with the chosen word. The Cancel button at the bottom allows you to close the Guess window without choosing an alternate word. If no correctly spelled words are found by Speller, the Cancel button will change to None Found.
Of course, angy is not a word. In fact, Speller beeped at you when you typed the 'y'. The word we really wanted was angry and since we left out the 'r', it was not spelled correctly. Luckily, Speller can figure out these kinds of common mistakes and correct them for you. Click on the angry button and watch what happens. Speller backspaces over angy and replaces it with angry. Try other words and pick Guess to see what happens. It will even find the correct word when you switch 2 letters within a word, such as - "recieve". Try it, then just click the correct button and leave the typing to Speller.
Note: This function will only work when Speller's window is behind your word processor's window.
Macro or (option backspace - delete on some keyboards)
The Macro function is unique and powerful. To fully understand it's capabilities, let's first use another of Speller's functions to explain.
Make Macros...
Choose Make Macros from the Speller menu. The following dialog box will appear.
Now type the following into the appropriate places.
When you are done typing click the Save & Quit button and you will see just how the Macro function works.
Using Macro
Your word processor document should now be in front of all other windows (including Speller). Type (all as one word) testmacro and then choose Macro from the Speller menu. Speller's window will briefly come in front of your word processor's window. Then the word testmacro will be backspaced over and the text you typed into the Make Macros dialog box will appear. It's that easy.
Try it with your initials. First choose Make Macros from the menu and then type your initials into the box marked Macro Name:. Next type your full name, including address if you like, into the box marked Expanded Text. Click on the Save & Quit button and return to your word processor window. Type your initials and choose Macro from the Speller menu. Like magic your name and address appear after you only typed 2 or 3 letters! The possibilities are endless!
Instead of choosing Macro from the menu, you can hold down the option key and press backspace (delete key).
Please Note: There is a limit of 255 characters that can be typed into the Make Macros dialog box. However, you can have much longer expanded text if you type it into the Speller Macros file yourself. It can be a page or 2 pages or more, all recalled with just one key word. See the section "Macro Rules" at the end of this booklet.
Thesaurus...
The Thesaurus is a separate file containing root words and synonyms. For example: (with your word processor's window in front of Speller's) type the word able and choose Thesaurus from Speller's menu. You will see the following:
The Thesaurus window works the same as the Guess window. The word you typed is at the top and the synonyms are shown below in buttons. Click on the button (word) you want and it will replace the word you typed in your text. If you do not want to use any of the synonyms that are found, simply click the Cancel button. If no synonyms are found, the Cancel button will change to None Found.
Check Selection...
The best way to use Speller is to check your spelling as you type. However, you may check a selected portion of text (hilited). Type a sentence or two using your word processor. With your word processor's window in front of Speller, choose Check Selection from Speller's menu. Speller's window will come to the front and expand. A portion of the Check Selection window is shown below with some sample text.
You will notice that there are 3 buttons in Speller's expanded window. There is also a long rectangle with 0% and 100% above it. This box gradually turns black to show the progress of Check Selection. When it is completely black, Check Selection is done and Speller will automatically return it's window to the bottom of the screen and put itself behind your word processor's window.
In the example above, Speller has stopped on a misspelled word. At this point you may do one of 3 things.
1) Click the Add to Dictionary button to add the Typed word (worx) to the Dictionary.
2) Click the Return button to go back to your word processor document (window). If you choose Return, Speller's window will go behind the word processor's window.
3) Click the Continue button to go on and check more words. Clicking in the Continue button will cause it to change to Stop and then you may click the Stop button if you wish to stop checking.
When you click in the Continue button you have an option. If you hold down the option key while you click in the Continue button, Check Selection will not stop on every error. It will beep when it finds an error but it will not stop until finished (unless you click Stop). You can also invoke - Nonstop checking of a selection by holding down the option key while you choose Check Selection from the menu.
All errors found during Check Selection will be saved for later viewing. Use the Show Errors command to show your misspelled words, one at a time.
Show Errors or (option S)
Show Errors is used after a selected portion of text is checked using Check Selection. Show Errors will show each misspelled word (one at a time) in Speller's window. The word you typed will appear in the Typed box and the word Speller found appears in the Found box, etc.. One way to take advantage of this feature is to use the word processors Replace or Change dialog box. You can first show an error (then click in the "Find" part of the Replace dialog). Next, choose Paste Typed from Speller's menu. The misspelled word will be typed into the "Find" box. Then click in the "Replace with" box of the word processors dialog. Follow this with choosing Paste Found from Speller's menu (assuming Speller found the correct word). The correct word will then be typed into the "Replace with" box. Click the "Find" button of the Replace dialog and then replace the incorrect word with the correct one. Continue this process until you have corrected all your errors.
Word Count
The Word Count command will show you the number of words checked by Check Selection and the number of misspelled words found. The number of words checked appears in the Found box and the number of errors appears in the Typed box of Speller's window.
Fix - Finish or (option Z)
Fix - Finish is a handy feature for fixing or finishing a word you are typing. Type possi and then choose Fix - Finish from the menu (or option Z). The letters possi will be backspaced over and replaced with possibilities. That is because possibilities is the word Speller found when you typed possi. Try this: type possi and then click on Speller's window (to bring it to the front).Then use the scroll bar to scroll to postcard, next click on your word processor window (to bring it to the front) and choose Fix - Finish from the menu. The possi you typed will be "fixed" to be postcard. So you can see that the Typed word is fixed or finished to change it into the word in the Found box (even if you had scrolled to it with the scroll bar on Speller's window).
Paste Found or (option F)
Paste Found will type the word in the Found box into any place you want it. You can look through the Dictionary until you find the word you want, then click on your word processor window and choose Paste Found from the menu. The word in the Found box will be typed into your document.
Paste Typed or (option T)
Paste Typed is most useful when using Show Errors as described above. This function will type the word in the Typed box into your document or a "Find" or "Replace" dialog. (Wherever you want it.)
Add Typed to Dict.
Add Typed to Dict. will take the word from the Typed box and add it to the Dictionary. If the word is already in the Dictionary, Speller will beep.
Delete Found
Delete Found will remove the word matching the one in the Found box from the Dictionary. Example: sorry is the word in the Found box - and you choose Delete Found from the menu - sorry will be removed from the Dictionary. The next time you type sorry, Speller will tell you that you made a mistake (the word is not in the Dictionary).
Make Macros...
See above.
Beep
A check mark by Beep means that Speller will beep the Mac's speaker when you misspell a word. You can remove the check mark by choosing Beep from the menu. Without the check mark, Speller will not beep when mistakes occur. To put the check mark back, simply choose Beep again.
Clear or (option C)
See above.
Return
The Return command is included as an easy way to move Speller's window to the bottom of the screen and put it behind your word processor's window.
Opening Dictionaries
If an error occurs during the opening of a Dictionary file, Speller will beep 2 times for a Disk Error (damaged disk) or 3 times for a Size Error (the Dictionary is too large for the available memory).
You may use other Dictionaries with Speller, such as the smaller one included on the Speller master disk. (Speller.Dictionary(21K)) To open a different Dictionary, hold down (and keep holding) the option key while you choose Graham Speller from the menu. You will see an "Open" dialog so you can select the Dictionary to open. This is also a way to use other Macro or Thesaurus files. The Macro and Thesaurus files must be in the same folder as the Dictionary. So if you have 2 different Dictionaries, you can have 2 different Macro files etc..
The Shift and Caps Lock Keys
The shift key or the caps lock key can be used to modify the effect of many commands in Speller. Holding down the shift key will capitalize the first letter of a word and locking down the caps lock key will cause every letter of a word to be capitalized. These features work with the following commands:
Guess
Thesaurus
Fix - Finish
Paste Found
Paste Typed
In other words, holding down the shift key when you choose Fix - Finish (or type option Z while holding shift down) will cause the word being fixed to have a capital at it's beginning. Locking down the caps lock key will cause every letter of the fixed word to be capitalized. The same is true for the Paste Found and Paste Typed functions.
With Guess and Thesaurus, hold down the appropriate key when clicking in the button of the word you want. For example: type boy and choose Guess from the menu. Hold down the shift key before (and while) you click joy and then Joy will be typed into your text (capital J ).
The Option Key
All of Speller's keyboard commands use the option key so that they will not conflict with those of the program it is working with. The characters "beneath" those keys (option S = ß,Z = Ω,F = ƒ,T = †,C = ç) can be obtained by clearing Speller (Clear from the menu or option C) and then holding down the option key combination you want until the character appears. Example - you want to type a Ω - Clear speller then hold down option and type z until the Ω appears.
The Shift Key with Macros
The shift key has a special purpose with the Macro function, especially when using a special Macro file designed just for Macintosh programmers. (See below) The shift key will eliminate any "comments" placed in the Macro file. These are in the form:
tabtabsemicoloncomment - or tabtableftcurlybracecomment There can be several tabs before the semicolon. If the shift key is held down during Macro, all characters including the tabs will be removed through the end of the line.
Example of using shift during Macro:
Text of several wordstabtabsemicoloncomments followed by a return
"Text of several words" would be pasted into your document. But, all characters after the tab (including the tab) will be removed - and not pasted into the document.
Thesaurus Rules
You may choose to add your own words to the Thesaurus. You must follow certain rules so that this function will continue to work properly. The Thesaurus file must be a TEXT file, do not convert it to any other format or it will not work with Speller!!!!
1) The Thesaurus contains a root word followed by a tab and then a synonym, then another tab and then the second synonym etc. until all the synonyms have been entered (maximum of 10). Follow the last synonym with a return (go to the next line).
2) Do not use anything in the Thesaurus file except lowercase (small) letters. Do not use capital letters. No spaces or punctuation of any kind are allowed (except for tabs and returns).
3) Always remember to put a return after each line.
Of course, the tabs and returns are invisible to you, but Speller needs them. Notice that there are no spaces. Here is an actual example:
abletabcapabletabcompetenttabqualifiedreturn
Macro Rules
This section of the booklet explains how to make your own Macros. If you want, you can skip this part and come back to it when you need to know how it's done.
The Make Macros dialog will "police" your actions so that you really can't make a mistake. If you enter more than 255 characters (letters & numbers etc.) Speller will only save the first 255 of them. To make longer Macros (the expanded text) you must use a word processor and follow the rules stated below. (Less than 255 characters - use the Make Macros dialog - it's easier!). The Macro file must be a TEXT file, do not convert it to any other format or it will not work with Speller!!!!
Here are the rules for Macros:
1) The Macro Name or keyword, must be all one continuous word - no spaces. It may not contain any punctuation or numbers. Use only the letters in the alphabet - a thru z.
Examples; anyword is ok but any word is not since it contains a space. anytwo is ok but any2 is not since it contains the numeral 2.
2) The expanded text may contain anything you want except for the identifiers needed to mark the beginning and end of each Macro (explained in rule 3).
3) Identifiers - There are 3 identifiers used. One is used to mark the beginning of the Macro name (keyword) and one marks the end of the Macro name and the 3rd marks the end of the expanded text. They are:
a) "<<" 2 less than signs mark the beginning of a Macro name (keyword).
b) ">>" 2 greater than signs followed by a return mark the end of a Macro name (keyword).
c) "}}" 2 right curly braces mark the end of the expanded text.
The form is:
<<macroname>>
Expanded text consisting of whatever you want including !@# etc....}}
Examples - the keyword might be newbornbaby (all one word - no spaces) and the expanded text would be - Her name is Melissa and she was born at 1:14 a.m. in the morning on Sunday.
In the Macro file it would look like this:
<<newbornbaby>>
Her name is Melissa and she was born at 1:14 a.m. in the morning on Sunday.}}
You must have the return after the keyword's two >> (greater than) signs. When you type newbornbaby and choose Macro from the menu, the text Her name is Melissa and she was born at 1:14 a.m. in the morning on Sunday will be placed into your document.
Example 2:
keyword of ouraddress and expanded text of
Graham Software Co.
8609 Ingalls Circle
Arvada, Colorado 80003
In the Macro file it would look like this:
<<ouraddress>>
Graham Software Co.
8609 Ingalls Circle
Arvada, Colorado 80003}}
If you want a return within the expanded text (at the end) just type a return before you put in the two }} (curly braces).
About Graham Software
Graham Software is dedicated to bringing you quality software at affordable prices. Your support and recommendations are very important to us. If you like Graham Speller, please tell some fellow Macintosh owners about it. If you don't like it or feel that it can be significantly improved, tell us; we'll listen and take your remarks into consideration for future Graham Speller releases.
Other Graham Software Products
Programmer's Macro Files for use with Graham Speller are available with either Pascal or Assembly language ROM call routines from Inside Macintosh . These files will save many hours of time for a programmer. You can quickly paste a ROM call routine into your document instead of having to look it up in Inside Macintosh.
Disk Ranger and Ranger Reader are 2 excellent programs that are sold as one. Disk Ranger catalogs disks and makes disk labels. Ranger Reader is a desk accessory that will read Disk Ranger catalogs from within any other program. This allows you to locate a file on any disk in your collection within seconds!
Please contact Graham Software Co. for more details.
